august 1998 1/5 this is advance information from stmicroelectronics. details are subject to change without notice. ST6-SW software development tools for st6 mcu family complete software development sup- port the ast6 macro-asssembler, lst6 linker and wgdb windos gnu debugger support the whole range of st6 microconrolers including all the dif- ferent variations. main features n macro-assembler (ast6) C support for nested macros C conditional assembly C support for paged data space C support for data rom window C generates intel .hex format executable files, listing files or object files. n linker (lst6) C links up to 32 modules C extensive symbol manipulation C 33 sections (including interrupt vectors) C error diagnostics C generates mapping information, cross refer- ence tables, symbol tables C rom masking option C generates intel .hex format executable files C optional generation of symbol information for source level debugger and emulator n windows gnu debugger (wgdb6) C source level debugging C supports gnu sdb commands C runs under windows 3.x, windows 95 and windows nt C works with st6 simulator, st6 starter kits or st6 hds emulators C software breakpoints definable on source or disassembled code. C memory breakpoints triggered on access to a pre-defined area of memory and optionally when a hardware-related condition is met. C line-by-line source code and machine code execution. function calls can optionally be considered as a single instruction, depending on the tracing level. C keep a trace of memory access during pro- gram execution. C view the stack contents. C view and modify the simulated/emulated st6 memory and register contents. C view and modify data symbol values in real time, while the program is running. C automatically execution of gdb6 command batch files, with or without the wgdb6 graph- ical interface, at start-up. macro-assembler (ast6) the st6 macro assembler accepts a source file written in st6 assembly language and transforms it into an executable file in relocatable object code format. when the whole program is in one file on- ly, the assembler also generates an hexadecimal file (intel hex format) ready to be programmed into an eprom device. the assembler recognizes the use of section, symbols, macros and conditional assembly direc- tives. in addition, the st6 assembler is able to produce detailed assembly listing and symbol cross reference file. linker (lst6) the st6 linker is responsible for combining a number of object files into a single program, asso- ciating an absolute address to each section of code, and resolving any external references. the st6 linker produces a hexadecimal file in in- tel format to be down loaded into an eprom de- vice and an object code file to be used with the simulator. the linker also produces a map file which gives information about the sections, pag- es, modules and labels. finally, listing files are produced which update the assembler listings with real addresses of symbols and statements. this software program allows the user to develop modular programs, which may then be combined and addressed as defined by the user. the flexibil- ity of the st6 linker is greatly increased by the use of sections allowing the user to group pieces of software from different modules. the location and the size of each section is user selectable. 721
2/5 ST6-SW windows gnu debugger (wgdb6) wgdb6 is a debugger for programs developed using either the st6 macro-assembler (ast6) or the st6 c compiler. it uses the gnu debugger (gdb) command set, with additional st6-specific commands, allowing execution of any of these commands by choosing the appropriate item from the standard windows interface. configuration wgdb6 can be used either with the st6 simula- tor, the st6 starter kit or the st6 hds emulator. C st6 simulator is a program that simulates the execution of st6 programs. it includes wave form editor, that enables the simulation of st6 pin input and output. C st6 starter kits include the simulator and a board that simulates the st6 pin input and out- put. C st6 hds emulators are hardware devices that enable real-time execution of st6 applications. the emulator can be connected to your own board, offering the same debugging capacities as the simulator. general description wgdb6 enables the user to execute st6 pro- grams, and view the contents of the st6 data and program memory as the program progresses. you can examine source code, as you would with a c- language source program, and assembler code. program execution history can be viewed at source or instruction level using the trace and stack displays. wgdb6 lets you read and write all st6 registers and memory locations. data display wgdb6 can display data in either normal, hot or real-time. normal display data is displayed as it was when you chose to view it, it is not automati- cally updated. normal display data is displayed on a white background. hot display data is updated every time the execution of the program you are debugging is suspended, and is displayed on a yellow background. real-time display data is up- dated as the program is running, and is displayed on a red background. figure 1. using wgdb6 with st simulator figure 2. using wgdb6 with the st6 starter kit figure 3. using wgdb6 with the st6 hds emulator simulator wgdb6 wave form editor starter kit board lpt1/lpt2 wgdb6 simulator lpt1/lpt2 emulator hds2 wgdb6 board probe com1/com2 emulator hds1 wgdb6 board probe 722
3/5 ST6-SW workspaces wgdb6 enables you to save and load workspac- es. workspaces are snapshots of windows and option choices that are taken when you close a program. each program you debug using wgdb6 has its own default workspace definition. when you load a program, the workspace that you were using when you last closed it is restored, thus you can continue working from where you left off. you can also save workspace definitions at any time, so that you can restore them at a later date. figure 4. development flow chart. assembler source file ast6 assembler file wgdb6 debugger st6 simulator st6 emulator st6 microcontroller listing file ast6 assembler object file lst6 linker file (.hex) executable listing file map file process using one source file (.asm) executable (.hex) process using modular source files assembler source file (.asm) assembler source file (.asm) assembler source file (.asm) (.obj) object file (.obj) object file (.obj) (.lis) (.lis) (.map) (-l) (-o) (-o) (-o) ast6 assembler ast6 assembler (-l) (-m) the letters in brackets indicate the run option needed to generate each file type. symbol file (.sym) (-s) data space symbol file (.dsd) = non-readable file = readable file 723
4/5 ST6-SW table 1. ast6 directives ordering information note : the st6 software package is included in all st6xxx-emu real time development tools. .ascii stores in program space a string as a sequence of ascii codes .asciz same as.ascii followed by a null character .block reserves a block of contiguous memory location .byte stores successive bytes of data in program space .def defines the characteristics of a data space location .display displays a string during assembly process .dp_on segments the data space .eject starts a new listing page .else beginning of the alternative part in conditional assembly block .end end of source file .endc end of conditional assembly block .endm end of a macro definition .equ assigns the value of an expression to a label .error user defined assembly error .extern defines a symbol as external .ifc beginning of conditional assembly block .input includes an additional source file in the present one .global defines a symbol as global .label.w initializes data rom window register .label.d gains access to a label in a data rom window .linesize set listing line length .list enables the listing of specified fields of the source file .macro beginning of a macro definition .mexit end of a macro expansion .notransmit inhibits symbol transmission to the linker .org set current location counter .page_d specifies the page number in data space .pl set listing page length .pp_on segments the program space in 2k pages .romsize defines the available rom size .section provides a logical partitioning of program space .set same as.equ, but can be redefined in the source file .title assigns title to the document .transmit transmits symbol definitions to the linker .vers defines the target st6 device .warning user defined assembly warning .window defines a continuous relocatable block of program code .w_on enables the use of the.window directive .word stores successive words of data in program space sales type description ST6-SW/pc st6 software development tools (includes ast6, lst6 and wgdb6) 724
5/5 ST6-SW notes information furnished is believed to be accurate and reliable. however, stmicroelectronics assumes no responsibility for the co nsequences of use of such information nor for any infringement of patents or other rights of third parties which may result from its use. no license is granted by implication or otherwise under any patent or patent rights of stmicroelectronics. specifications mentioned in this publicati on are subject to change without notice. this publication supersedes and replaces all information previously supplied. stmicroelectronics prod ucts are not authorized for use as critical components in life support devices or systems without the express written approval of stmicroele ctronics. the st logo is a registered trademark of stmicroelectronics ? 1998 stmicroelectronics - all rights reserved. purchase of i 2 c components by stmicroelectronics conveys a license under the philips i 2 c patent. rights to use these components in an i 2 c system is granted provided that the system conforms to the i 2 c standard specification as defined by philips. stmicroelectronics group of companies australia - brazil - canada - china - france - germany - italy - japan - korea - malaysia - malta - mexico - morocco - the neth erlands - singapore - spain - sweden - switzerland - taiwan - thailand - united kingdom - u.s.a. http://www.st.com
|
